Skip to content

[docs-infra] Deploy Docs to Netlify #1019

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
dav-is merged 16 commits into from
Jan 9, 2026
Merged

[docs-infra] Deploy Docs to Netlify #1019

dav-is merged 16 commits into from
Jan 9, 2026

Conversation

@dav-is
Copy link
Member

@dav-is dav-is commented Jan 5, 2026 •
edited
Loading

Adds Netlify config to deploy docs. Copies from base-ui:
https://github.com/mui/base-ui/blob/f68c8db5d87363520fad13fe2d33e560f822e77d/netlify.toml

Preview URL

master deploys to https://mui-internal.netlify.app/ for now
New Netlify Project: https://app.netlify.com/projects/mui-internal/overview

Also splits functions directory into factories and pipeline, reorders navigation, and fixes some colors

@dav-is dav-is added docs Improvements or additions to the documentation. scope: docs-infra Involves the docs-infra product (https://www.notion.so/mui-org/b9f676062eb94747b6768209f7751305). labels Jan 5, 2026
@mui-bot
Copy link

mui-bot commented Jan 5, 2026 •
edited
Loading

Bundle size report

Bundle Parsed size Gzip size
@base-ui-components/react 0B(0.00%) 0B(0.00%)
@mui/x-charts-pro 0B(0.00%) 0B(0.00%)

Details of bundle changes

Check out the code infra dashboard for more information about this PR.

@netlify
Copy link

netlify bot commented Jan 5, 2026 •
edited
Loading

✅ Deploy Preview for mui-internal ready!

Name Link
🔨 Latest commit 4b065b7
🔍 Latest deploy log https://app.netlify.com/projects/mui-internal/deploys/696008ededd5820008ce5c90
😎 Deploy Preview https://deploy-preview-1019--mui-internal.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@dav-is dav-is marked this pull request as ready for review January 5, 2026 20:13
@oliviertassinari oliviertassinari temporarily deployed to docs-infra/deploy-to-netlify - mui-tools-public PR #1019 January 6, 2026 19:29 — with Render Destroyed
@Janpot
Copy link
Member

Janpot commented Jan 8, 2026

Interesting, this broke preview urls for the code infra dashboard for all PRs.

@dav-is
Copy link
Member Author

dav-is commented Jan 8, 2026

@Janpot, I guess Netlify doesn't support multiple projects in a single repo. Their UI didn't warn me when I made the new mui-internal project

Since the code infra dashboard is migrated now, are we ready to merge this PR?

@oliviertassinari oliviertassinari temporarily deployed to docs-infra/deploy-to-netlify - mui-tools-public PR #1019 January 8, 2026 19:43 — with Render Destroyed
@oliviertassinari oliviertassinari temporarily deployed to docs-infra/deploy-to-netlify - code-infra-dashboard PR #1019 January 8, 2026 19:43 — with Render Destroyed
Janpot
Janpot requested changes Jan 9, 2026
View reviewed changes
Copy link
Member

@Janpot Janpot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should update

mui-public/package.json

Line 11 in 9510dc2

"update-netlify-ignore": "node ./update-netlify-ignore.mjs @apps/code-infra-dashboard",
to

"update-netlify-ignore": "node ./update-netlify-ignore.mjs docs",

and add the ignore tto netlify.toml

@dav-is
Copy link
Member Author

dav-is commented Jan 9, 2026

@Janpot Running node ./update-netlify-ignore.mjs docs returns Error: netlify.toml not found in /var/home/davis/Code/mui-public/docs because I added the netlify.toml in the root to mirror base-ui's setup: https://github.com/mui/base-ui/blob/master/netlify.toml

@netlify
Copy link

netlify bot commented Jan 9, 2026 •
edited
Loading

✅ Deploy Preview for mui-internal ready!

Name Link
🔨 Latest commit e741282
🔍 Latest deploy log https://app.netlify.com/projects/mui-internal/deploys/696173af29a4b60008d9acd7
😎 Deploy Preview https://deploy-preview-1019--mui-internal.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@Janpot
Copy link
Member

Janpot commented Jan 9, 2026

🤔 Ok, not sure if the script will work correctly for the root folder

@dav-is dav-is merged commit d4386da into master Jan 9, 2026
15 checks passed
@dav-is dav-is deleted the docs-infra/deploy-to-netlify branch January 9, 2026 21:36
@oliviertassinari oliviertassinari added the type: new feature Expand the scope of the product to solve a new problem. label Jan 27, 2026
@oliviertassinari
Copy link
Member

oliviertassinari commented Jan 28, 2026 •
edited
Loading

Cool, great to have the infra with its own docs 👍. It seems to be about #946.

One thing I could spot opening #1067 is how Netlify sends noise CI checks:

SCR-20260128-bvmr

We disabled those for the other Netlify deploy instances.

I went ahead and did the same. And because this could be the tip of an iceberg, I ported back settings from the other Netlify instances:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@Janpot Janpot Janpot approved these changes

Assignees

No one assigned

Labels

docs Improvements or additions to the documentation. scope: docs-infra Involves the docs-infra product (https://www.notion.so/mui-org/b9f676062eb94747b6768209f7751305). type: new feature Expand the scope of the product to solve a new problem.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@dav-is @mui-bot @Janpot @oliviertassinari